Meal Gauge Element
The Meal Gauge Element displays a meal icon comprised of buttons that represent quarters/percentages - i.e., 25%, 50%, 75%, and 100% - from which the user can select 1, 2, 3, or all 4 quarters. Within healthcare settings in particular, the Meal Gauge Element has a variety of applications including using it to represent how much of a meal has been consumed by a patient, how full a patient feels, or how big a portion a patient would like to be served etc. When a Meal Gauge Element has been added to the form, at runtime, it will be displayed as follows:
Each quarter of the Meal Gauge Element can be selected or deselected individually to represent a percentage amount, and one or more quarters of the Element can be configured to be pre-selected/to act as the default, as discussed below.
Once you have placed a Meal Gauge Element on a page, you can edit the Element's properties to configure the Element for your requirements. Select the Element on the page to display its properties in the Properties Pane.
The following properties are available:
Element Version
The Element's version number, which may be (and is often) different to the installed version of the Digitise Forms software. For example, the version of the Element might be 1.5, but the version of the in-use/installed Digitise Forms software might be 2.0 etc.
Label
Allows you to change the text displayed in the label for this Element. You can change the default label to provide a more meaningful description or option for your users.
Visible and Disabled Properties
Show Label
Lets you show or hide the Element's label at form runtime. To hide the label so that the facial expressions only are displayed, deselect this option.
Size
Allows you to specify the size of the Meal Gauge quarters. The options available are Small, Medium, and Large.
Layout
Allows you to specify the position/alignment of the Meal Gauge icon within the Element. The options available are Left, Right, and Center.
Value
Contains the selected value for the Meal Gauge Element. A number corresponding to one or more of the four quarters can be chosen from a list to act as the default/pre-selected option, using the up and down arrows at the right-hand side of the property. The list contains the values 0 (for no quarter selected), 25, 50, 75, and 100. Alternatively, you can specify an input mapping to read the default/pre-selected value in from a Datasource, but no quarter will be selected at runtime if the value isn't 25, 50, 75, or 100.
For more information about mapping properties to data items in a Datasource see Data Tab Properties.
Styles Category
Label
Allows you to assign a style to the Element's label, e.g., to set the font type, size, and colour.
Buttons
Allows you to assign a style to the Quarter buttons that comprise the Meal Gauge Element.
Error Message
Allows you to assign a style to the invalid data error message text.